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Apple /// 
Apple ///+ 



Apple /// SOS Technical Information 



SOS 1.3 

Floppy Bootstrap Loader 
Source Code Listing 

This listing shows the code which is found at the beginning of 
a SOS boot disk. When the Apple /// computer starts the 
computer's ROM loads this code from die floppy disk 
and executes the code. This code loads the Apple Ill's 

operating system, SOS. 
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A024 1 
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A2 A2 
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Of 



t APPLE /// BOOTSTRAP LOADER FOR FLOPPY DISK 
4 - Disassembled 10-March-1988 by Scott Stinson 

\ 



.ABSOLUTE 

.PROC BOOTSTRAPLOADER 
.ORG 0A000 



EQUATES 



; ZERO PAGE LOCATIONS 



1 



IBDRVN 


.EQU 


82 


• DRIVE NUMBER 


IBTRK 


.EQU 


83 


' TRACK NUMBER 


IBSECT 


.EQU 


84 


• SECTOR NUMBER 


IBBUFP 


.EQU 


85 


• BUFFER POINTER 


IBCMD 


.EQU 


87 


■ COMMAND NUMBER 


IBBUFPTMP 


.EQU 


0E3 


■ BUFFER POINTER TEMPORARY 


FILECNT 


.EQU 


0E5 


■ FILE COUNT 


INDXBLKCNT 


.EQU 


0E7 


• INDEX BLOCK COUNT 


SOSJMPADR 


.EQU 


0E8 


• SOS JUMP ADDRESS 


; HARDWARE 


I/O ADDRESSES 




SCREENLOC 


.EQU 


0628 


SCREEN LOCATION 


KBD STROBE 


.EQU 


0C010 


■ KEYBOARD STROBE 


IOBEEP 


.EQU 


0C040 


• I/O BEEP 


; GENERAL EQUATES 


RET I NT 


.EQU 


40 


RETURN FROM INTERRUPT 


IDXBLK1 


.EQU 


0C00 


• INDEX BLOCK 1 


IDXBLK2 


.EQU 


0D00 


• INDEX BLOCK 2 


LOADADR 


.EQU 


1E00 


• LOADING ADDRESS 


OFFSET 


.EQU 


1E08 


• OFFSET 


FIRSTPAGE 


.EQU 


2000 


• FIRST PAGE 


MAINBUFF 


.EQU 


0A200 


MAIN BUFFER 


REGRWTS 


.EQU 


0F000 , 


READ/WRITE SECTOR ROUTINE 


SECTABL 


.EQU 


0F4A0 


SECTOR TABLE 


NMIVECTOR 


.EQU 


0FFCA 


NON-MASKABLE INTERRUPT VECTOR 


EREG 


-EQU 


0FFDF 


ENVIRONMENT REGISTER 


BREG 


• EQU 


0FFEF 


BANK REGISTER 



ENTRY POINT 



ENTRY 



$010 



SEI 
CLD 
LDA 
STA 



LDX 
TXS 
BIT 
LDA 
STA 
LDA 
STA 
LDA 
DEC 
STA 
LDX 
BNE 



#77 
EREG 



#0FF 

KBDSTROBE 

#RETINT 

NMIVECTOR 

#07 

BREG 

#00 

BREG 

FIRSTPAGE 
FIRSTPAGE 
$010 



SET INTERRUPT DISABLE 

CLEAR DECIMAL FLAG 

LOAD ACCUMULATOR WITH $77 

STORE IN ENVIRONMENT REGISTER 

SET 2 MHZ, I/O SPACE ENABLED, SCREEN ENABLED, 

RESET ENABLED, WRITE PROTECT NOT ENABLED, 

PRIMARY STACK, AND ROM SELECTED 

LOAD ACCUMULATOR WITH $FF 

TRANSFER X-REGISTER TO STACK POINTER 

CLEAR KEYBOARD 

LOAD ACCUMULATOR WITH RETURN FROM INTERRUPT 

STORE IN NON-MASKABLE INTERRUPT VECTOR 

LOAD ACCUMULATOR WITH $07 

STORE IN BANK REGISTER 

LOAD ACCUMULATOR WITH $00 

DECREMENT BANK REGISTER 

STORE IN FIRST PAGE OF BANK 

LOAD X-REGISTER WITH FIRST PAGE BYTE 

BRANCH IF BYTE IS NOT EQUAL TO $00 



This section reads in the SOS directory, 



READSOSDIR LDA 
STA 
LDX 
STX 
LDX 

RDSOSDIRLP LDY 
STY 
LDY 
STY 
JSR 



#00 

IBBUFP 

#0A2 

IBBUFP+1 
#02 

IBBUFP 

IBBUFPTMP 

IBBUFP+1 

IBBUFPTMP+1 

READBLK 



LOAD ACCUMULATOR WITH $00-BLOCK HIGH BYTE 

STORE IN BUFFER POINTER LOW BYTE 

LOAD X-REGISTER WITH $A2 

STORE IN BUFFER POINTER HIGH BYTE 

LOAD X-REGISTER WITH $02-BLOCK LOW BYTE 

LOAD Y-REGISTER WITH BUFFER POINTER LOW BYTE 

STORE IN BUFFER POINTER TEMPORARY LOW BYTE 

LOAD Y-REGISTER WITH BUFFER POINTER HIGH BYTE 

STORE IN BUFFER POINTER TEMPORARY HIGH BYTE 

JUMP TO READ A BLOCK FROM FLOPPY DISK DRIVE 



l Source: David T. Craig 
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A039 
A03B 
A03D 
A03D 
A03E 
A03F 
A041 
A041 
A043 
A043 
A045 
A045 
A04 7 
A047 
A04 7 
A047 
A047 
A04 7 
A04 7 
A04A 
A04C 
A04F 
A051 
A053 
A055 
A058 
A058 
A05A 
A05C 
A05E 
A060 
A062 
A064 
A06 6 
A068 
A06B 
A06C 
A06E 
A070 
A070 
A072 
A074 
A077 
A07 9 
A07A 
A07C 
A07F 
A081 
A082 
A084 
A086 
A08 6 
A088 
A08A 
A08C 
A08D 
A08E 
A090 
A091 
A093 
A096 
A098 
A09A 
A09C 
A09E 
A0A0i 
A0A2! 
A0A4 
A0A6 
A0A9 
A0AA 
A0AC 
A0AD 
A0AF 
A0B1 
A0B3 
A0B5 
A0B7 
A0B9 
A0BB 
A0BE 
A0BE 
A0BE 
A0BE 
A0BE 
A0BE 
A0BE 
A0C0 
A0C2 
A0C3 



A0 02 
Bl E3 

AA 
C8 

Bl E3 
D0EB 
E0 00 
D0E7 



LDY 


#02 




■ LOAD Y-REGISTER WITH $02 


LDA 


0IBBUFPTMP, 


Y 


' LOAD ACCUMULATOR WITH NEXT BLOCK TO READ LOW 
• BYTE 


TAX 






• TRANSFER ACCUMULATOR TO X-REGISTER 


INY 






• INCREMENT Y-REGISTER 


LDA 


@IBBUFPTMP, 


Y 


• LOAD ACCUMULATOR WITH NEXT BLOCK TO READ HIGH 

• BYTE 


BNE 


RDSOSDIRLP 




• BRANCH IF NEXT BLOCK TO READ HIGH BYTE IS NOT 

• EQUAL TO ZERO 


CPX 


#00 




• CHECK TO SEE IF NEXT BLOCK TO READ LOW BYTE IS 

• ZERO 


BNE 


RDSOSDIRLP 




• BRANCH IF NEXT BLOCK TO READ LOW BYTE IS NOT 

• EQUAL TO ZERO 



This section searches the SOS directory for the SOS. KERNEL file, 



j AD 25A2 




LDA 


Ma TwnnTTT-i-9 ^ 
M/ilNrJUr r +z o 


1 85 E5 




STA 


FILECNT 


1 AD 2 6A2 




LDA 


MAINBUFF+2 6 


I 85 E6 




STA 


TT T prMTi 1 
r 1 i_itiL.M l+ 1 


1 05 E5 




ORA 


r l Lit ^ In l 


1 D003 




BNE 


ton rf. 


1 4C 56A1 




TMD 


WKNIi! NUcjKK 


1 A5 E5 


$010 


LDA 


r ± ±jHi in x 


1 D002 




own. 


$020 


1 C6 E6 




DEC 


ITT T TCWTa- 1 


1 C6 E5 


$020 


DEC 


r j. j-i£j wn i 


1 A9 2B 




LDA 


If C.D 


I 85 85 




STA 


IBBUFP 


1 A9 A2 




LDA 


#0A2 


1 85 86 




STA 


IDDUr I Ti 


1 AE 24A2 




LDX 




I CA 




DEX 




1 A0 00 


SRCHLP 


LDY 


#00 


1 Bl 85 




LDA 


B T RRnP"P Y 

C -L DDUr IT , 1 


1 F01A 




BEQ 


$020 


1 29 0F 




AND 


#0F 


I CD 92A1 




CMP 


r J-j in 1 1 Hj i_i Hi in 


I D013 




BNE 


$020 


I A8 




TAY 




I Bl 85 


$010 


LDA 


@ IBBUFP, Y 


1 D9 92A1 




CMP 


FLNME— 1 Y 


1 D00B 




BNE 


$020 


I 88 




DEY 




1 D0F6 




BNE 


$010 


1 Bl 85 




LDA 


@ IBBUFP, Y 


1 29 F0 




AND 


#0F0 


1 C9 20 




CMP 


#20 


1 F032 




BEQ 


READIDXBLK 


1 08 


$020 


PHP 




1 CA 




DEX 




I F010 




BEQ 


$030 


1 18 




CLC 




I A5 85 




LDA 


IBBUFP 


I 6D 23A2 




ADC 


MAINBUFF+2 3 


1 85 85 




STA 


IBBUFP 


1 A5 86 




LDA 


IBBUFP+1 


1 6 9 00 




ADC 


#00 


I 85 86 




STA 


IBBUFP+1 


I D009 




BNE 


$040 


I A9 04 


$030 


LDA 


#04 


85 85 




STA 


IBBUFP 


1 E6 86 




INC 


IBBUFP+1 


AE 24A2 




LDX 


MAINBUFF+2 4 


28 


$040 


PLP 




F0C0 




BEQ 


SRCHLP 


38 




SEC 




A5 E5 




LDA 


FILECNT 


E9 01 




SBC 


#01 


85 E5 




STA 


FILECNT 


A5 E6 




LDA 


FILECNT+1 


E9 00 




SBC 


#00 


85 E6 




STA 


FILECNT+1 


B0B1 




BCS 


SRCHLP 


4C 56A1 




JMP 


WRNTFNDERR 



LOAD ACCUMULATOR WITH FILE COUNT LOW BYTE 

STORE IN FILE COUNT LOW BYTE 

LOAD ACCUMULATOR WITH FILE COUNT HIGH BYTE 

STORE IN FILE COUNT HIGH BYTE 

OR ACCUMULATOR WITH FILE COUNT LOW BYTE 

BRANCH IF FILE COUNT IS NOT EQUAL TO ZERO 

JUMP TO WRITE NOT FOUND ERROR MESSAGE TO 

SCREEN 

LOAD ACCUMULATOR WITH FILE COUNT LOW BYTE 

BRANCH IF NOT EQUAL TO $00 

DECREMENT FILE COUNT HIGH BYTE 

DECREMENT FILE COUNT LOW BYTE 

LOAD ACCUMULATOR WITH $28 

STORE IN BUFFER POINTER LOW BYTE 

LOAD ACCUMULATOR WITH $A2 

STORE IN BUFFER POINTER HIGH BYTE 

LOAD X-REGISTER WITH ENTRIES PER BLOCK 

DECREMENT X-REGISTER 

LOAD Y-REGISTER WITH $00 

LOAD ACCUMULATOR WITH STORAGE TYPE AND NAME 
LENGTH BYTE 

BRANCH IF EQUAL TO ZERO 
MASK OFF BITS 4,5,6,7 
COMPARE WITH FILE NAME LENGTH 
BRANCH IF NOT EQUAL TO ZERO 
TRANSFER NAME LENGTH TO Y-REGISTER 
LOAD ACCUMULATOR WITH FILE NAME BYTE 
COMPARE WITH FILE NAME BYTE 
BRANCH IF NOT EQUAL 
DECREMENT NAME LENGTH 

BRANCH IF NAME LENGTH NOT EQUAL TO ZERO 

LOAD ACCUMULATOR WITH STORAGE TYPE AND NAME 

LENGTH BYTE 

MASK OFF BITS 0,1,2,3 

COMPARE WITH $20 FOR SAPLING FILE 

BRANCH IF EQUAL TO READ INDEX BLOCK 

PUSH PROCESSOR STATUS ON STACK 

DECREMENT ENTRIES PER BLOCK 

BRANCH IF ENTRIES PER BLOCK IS EQUAL TO ZERO 
CLEAR CARRY 

LOAD ACCUMULATOR WITH BUFFER POINTER LOW BYTE 

ADD ENTRY LENGTH LOW BYTE 

STORE IN BUFFER POINTER LOW BYTE 

LOAD ACCUMULATOR WITH BUFFER POINTER HIGH BYTE 

ADD $00 

STORE IN BUFFER POINTER HIGH BYTE 

BRANCH ALWAYS 

LOAD ACCUMULATOR WITH $04 

STORE IN BUFFER POINTER LOW BYTE 

INCREMENT BUFFER POINTER HIGH BYTE 

LOAD X-REGISTER WITH ENTRIES PER BLOCK 

PULL PROCESSOR STATUS FROM STACK 

BRANCH IF NOT EQUAL TO ZERO 

SET CARRY 

LOAD ACCUMULATOR WITH FILE COUNT LOW BYTE 
SUBTRACT $01 

STORE IN FILE COUNT LOW BYTE 

LOAD ACCUMULATOR WITH FILE COUNT HIGH BYTE 

SUBTRACT $00 

STORE IN FILE COUNT HIGH BYTE 

BRANCH IF MORE FILE ENTRIES 

JUMP TO WRITE NOT FOUND ERROR MESSAGE TO 

SCREEN 



This section reads in the index block of the SOS. KERNEL file. 



A0 11 
Bl 85 
AA 



READIDXBLK LDY 
LDA 
TAX 



#11 ; LOAD Y-REGISTER WITH $11 

@IBBUFP,Y ; LOAD KEY POINTER LOW BYTE 

; TRANSFER ACCUMULATOR TO X- 

; BYTE 



•REGISTER-BLOCK LOW 



l Source: David T. Craig 
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A0C3 

A0C4 

A0C6 

A0C8 

A0CA 

A0CC 

A0CE 

A0D1 

A0D1 

A0D1 

A0D1 

A0D1 

A0D1 

A0D4 

A0D7 

A0D9 

A0DB 

A0DD 

A0DF 

A0E2 

A0E2 

A0E2 

A0E2 

A0E2 

A0E2 

A0E2 

A0E2 

A0E4 

A0E7 

A0EA 

A0EC 

A0EF 

A0EF 

A0F0 

A0F2 

A0F2 

A0F2 

A0F2 

A0F2 

A0F2 

A0F2 

A0F4 

A0F6 

A0F8 

A0FB 

A0FE 

A100 

A102 

A102 

A104 

A107 

A109 

A10B 

A10B 

A10B 

A10B 

A10B 

A10B 

A10B 

A10C 

A10E 

Alll 

A113 

A115 

A118 

AHA 

A11D 

A11D 

A11D 

A11D 

A11D 

A11D 

A11D 

A11D 

A11F 

A120 

A122 

A123I 

A125; 

A126! 

A1281 

A129 

A129 

A12B 

A12C 

A12F 

A131 

A133 

A135 

A137 



C8 

Bl 85 
A0 00 
84 85 
A0 0C 
84 86 
20 1DA1 



AE 000C 
AD 000D 
A0 00 
84 85 
A0 IE 
84 86 
20 1DA1 



86 83 
4A 

66 83 
4A 

66 83 
4A 

66 83 
8A 

2 9 07 
AA 

BD A0F4 
85 84 
A9 01 
85 87 
A9 00 
85 82 



INY 




■ INCREMENT Y -REGISTER 


LDA 


0IBBUFP, Y 


■ LOAD KEY POINTER HIGH BYTE 


LDY 


#00 


• LOAD Y-REGISTER WITH $00 


STY 


IBBUFP 


' STORE IN BUFFER POINTER LOW BYTE 


LDY 


#0C 


• LOAD Y-REGISTER WITH $0C 


STY 


IBBUFP+1 


■ STORE IN BUFFER POINTER HIGH BYTE 


JSR 


READBLK 


• JUMP TO READ A BLOCK FROM FLOPPY DISK DRIVE 



This section reads in the first block of the SOS. KERNEL file. 



RD1SOSKER LDX 
LDA 
LDY 
STY 
LDY 
STY 
JSR 



IDXBLK1 

IDXBLK2 

#00 

IBBUFP 

#1E 

IBBUFP+1 
READBLK 



LOAD X-REGISTER WITH INDEX BLOCK LOW BYTE 

LOAD ACCUMULATOR WITH INDEX BLOCK HIGH BYTE 

LOAD Y-REGISTER WITH $00 

STORE IN BUFFER POINTER LOW BYTE 

LOAD Y-REGISTER WITH $1E 

STORE IN BUFFER POINTER HIGH BYTE 

JUMP TO READ A BLOCK FROM FLOPPY DISK DRIVE 



This section does a verification of the SOS. KERNEL file to make 
sure it is the proper SOS. KERNEL file. It checks for "SOS KRNL" in 
the first 8 bytes of the file. 



A0 08 


FLVRFY 


LDY 


#08 


B9 FF1D 


FLVRFYLP 


LDA 


LOADADR- 1 , Y 


D9 9CA1 




CMP 


FLVERIFY-1 , Y 


F003 




BEQ 


$010 


4C 6AA1 




JMP 


WRINKERERR 


88 


$010 


DEY 




D0F2 




BNE 


FLVRFYLP 



LOAD Y-REGISTER WITH $08 

LOAD ACCUMULATOR WITH BYTE FROM SOS. KERNEL 
COMPARE WITH VERIFICATION BYTE 
BRANCH IF EQUAL 

JUMP TO WRITE INVALID KERNEL ERROR MESSAGE TO 
SCREEN 

DECREMENT Y-REGISTER 

BRANCH IF NOT EQUAL TO ZERO TO CHECK REST OF 8 
SOS. KERNEL BYTES 



This section reads in the SOS. KERNEL file. 



A9 01 


RDSOSKER 


LDA 


#01 


85 E7 




STA 


INDXBLKCNT 


A4 E7 


RDSOSKELP 


LDY 


INDXBLKCNT 


BE 000C 




LDX 


IDXBLK1, Y 


B9 000D 




LDA 


IDXBLK2, Y 


D004 




BNE 


$010 


E0 00 




CPX 


#00 


F007 




BEQ 


JUMPSOSKER 


20 1DA1 


$010 


JSR 


READBLK 


E6 E7 




INC 


INDXBLKCNT 


D0EB 




BNE 


RDSOSKELP 



LOAD ACCUMULATOR WITH $01 

STORE IN INDEX BLOCK COUNT 

LOAD Y-REGISTER WITH INDEX BLOCK COUNT 

LOAD X-REGISTER WITH BLOCK LOW BYTE 

LOAD ACCUMULATOR WITH BLOCK HIGH BYTE 

BRANCH IF BLOCK HIGH BYTE IS NOT EQUAL TO ZERO 

CHECK TO SEE IF BLOCK LOW BYTE IS NOT EQUAL TO 

ZERO 

BRANCH IF BLOCK LOW BYTE IS NOT EQUAL TO ZERO 
JUMP TO READ A BLOCK FROM FLOPPY DISK DRIVE 
INCREMENT INDEX BLOCK COUNT 

BRANCH IF INDEX BLOCK COUNT IS NOT EQUAL TO 
ZERO TO READ MORE OF THE SOS. KERNEL 



This section jumps to the SOS. KERNEL loader, 



18 




JUMPSOSKER CLC 




A9 


0E 


LDA 


#0E 


6D 


081E 


ADC 


OFFSET 


85 


E8 


STA 


SOSJMPADR 


A9 


IE 


LDA 


#1E 


6D 


091E 


ADC 


OFFSET+1 


85 


E9 


STA 


SOSJMPADR+1 


6C 


E800 


JMP 


@ SOS JMP ADR 



CLEAR CARRY 

LOAD ACCUMULATOR WITH $0E 
ADD OFFSET LOW BYTE 

STORE IN SOS JUMP ADDRESS LOW BYTE 
LOAD ACCUMULATOR WITH $1E 
ADD OFFSET HIGH BYTE 

STORE IN SOS JUMP ADDRESS HIGH BYTE 
JUMP TO SOS. KERNEL LOADER 



This section reads a block of data from the floppy disk drive. 
On entry the x-register contains the block low byte and the 
accumulator contains the block high byte. 



READBLK 



STX 


IBTRK 


' STORE BLOCK LOW BYTE IN TRACK NUMBER 


LSR 


A 


• DIVIDE BLOCK BY 8 TO GET TRACK NUMBER 


ROR 


IBTRK 




LSR 


A 




ROR 


IBTRK 




LSR 


A 




ROR 


IBTRK 




TXA 




• TRANSFER X-REGISTER WHICH CONTAINS THE 

• LOW BYTE TO ACCUMULATOR 


AND 


#07 \ 


• MASK OFF BITS 3,4,5,6,7 


TAX 




• TRANSFER ACCUMULATOR TO X-REGISTER 


LDA 


SECTABL, X 


LOAD ACCUMULATOR WITH PROPER SECTOR TO 


STA 


IB SECT 


STORE IN SECTOR NUMBER 


LDA 


#01 


LOAD ACCUMULATOR WITH $01 


STA 


IBCMD 


STORE IN COMMAND NUMBER 


LDA 


#00 


LOAD ACCUMULATOR WITH $00 


STA 


IBDRVN 


STORE IN DRIVE NUMBER 



l Source: David T. Craig 



"J93.PICT" 819 KB 2001-08-13 dpi: 600h x 600v pix: 4690h x 6261v 

| Page 0006 of 0009 a 



Apple III Computer Information • Doc # 1 94 • SOS 1 .3 Floppy Loader Source 



10/31/89 9:45 


A139| 


20 


00F0 


A13C| 


9005 


A13E| 


A2 


FF 


A140| 


9A 




A141 1 


B03B 


A143| 


E6 


86 


A145| 


E6 


84 


A147 | 


E6 


84 


A14 9I 


20 


00F0 


A14C| 


9005 


A14E| 


A2 


FF 


A150| 


9A 




A151| 


B02B 


A153| 


E6 


86 


A155| 


60 




A156| 






A156I 






A156| 






A156| 






A156| 






A156| 


A2 


IB 


A158| 


A0 


21 


A15A| 


BD 


A4A1 


A15D| 






A15D| 


99 


2806 


A160I 


88 




A161 1 


CA 




A162 | 


D0F6 


A164 | 


AD 


40C0 


A167 | 


4C 


67A1 


A16A| 






A16A| 






A16A| 






A16A| 






A16A| 






A16A| 


A2 


13 


A16C| 


A0 


ID 


A16E| 


BD 


BFA1 


A171 1 






A171 1 


99 


2806 


A174 | 


88 




A175 | 


CA 




A176 j 


D0F6 


A178 j 


AD 


40C0 


A17B | 


4C 


7BA1 


A17E j 






A17E| 






A17E | 






A17E| 






A17E| 






A17EI 


A2 


0A 


A180| 


A0 


18 


A182 | 


BD 


D2A1 


A185 | 


99 


2806 


A188 | 


88 




A189 | 


CA 




A18A| 


D0F6 


A18CI 


AD 


40C0 


A18F| 


4C 


8FA1 


A192 | 






A192 | 






A192 | 






A192 | 






A192 | 






A192 | 


0A 




A193 j 


53 


4F 53 


A19A| 


4E 


45 4C 


A19D| 


53 


4F 53 


A1A4 | 


4C 




A1A5I 


46 


49 4C 


A1AC| 


4F 


53 2E 


A1B3 | 


45 


4C 27 


A1BA| 


20 


46 4F 


A1C0| 


49 


4E 56 


A1C7| 


20 


4B 45 


A1CEI 


20 


46 49 


A1D3| 


44 


49 53 


A1DA| 


52 


4F 52 


A1DD| 






A1DD| 







HD:Apple ///:SOS Floppy Bootstrap Loader 



Page 4 



'ROM,- 

Sector 



$010 



$020 



JSR 


REGRWTS 


• JUMP TO READ A SECTOR FROM FLOPPY DISK 


BCC 


$010 


• BRANCH IF NO DISK ERRORS OCCURED 


LDX 


#0FF 


• LOAD ACCUMULATOR WITH $FF 


TXS 




■ TRANSFER X-REGISTER TO STACK POINTER 


BCS 


WRDISKERR 


• BRANCH TO WRITE DISK ERROR MESSAGE TO SCREEN 


INC 


IBBUFP+1 


• INCREMENT BUFFER POINTER HIGH BYTE 


INC 


IBSECT 


■ INCREMENT SECTOR NUMBER 


INC 


IBSECT 


• INCREMENT SECTOR NUMBER 


JSR 


REGRWTS 


■ JUMP TO READ A SECTOR FROM FLOPPY DISK 


BCC 


$020 


■ BRANCH IF NO DISK ERRORS OCCURED 


LDX 


#0FF 


• LOAD ACCUMULATOR WITH $FF 


TXS 




• TRANSFER X-REGISTER TO STACK POINTER 


BCS 


WRDISKERR 


• BRANCH TO WRITE DISK ERROR MESSAGE TO SCREEN 


INC 


IBBUFP+1 


• INCREMENT BUFFER POINTER HIGH BYTE 


RTS 




RETURN TO CALLER 



This section writes the not found error message to the screen. 



WRNTFNDERR 


LDX 


#1B 


■ LOAD X-REGISTER WITH $1B 




LDY 


#21 


• LOAD Y-REGISTER WITH $21 


$010 


LDA 


NTFNDERR-1, X 


• LOAD ACCUMULATOR WITH NOT 








■ BYTE 




STA 


SCREENLOC, Y 


■ WRITE IT TO THE SCREEN 




DEY 




■ DECREMENT Y-REGISTER 




DEX 




■ DECREMENT X-REGISTER 




BNE 


$010 


• BRANCH IF MORE CHARACTERS 




LDA 


IOBEEP 


• BEEP SPEEKER 


$020 


JMP 


$020 


HANG FOREVER ! ! 



This section writes the invalid kernel error message to the screen. 



WRINKERERR LDX 
LDY 

$010 LDA 

STA 
DEY 
DEX 
BNE 
LDA 
JMP 



$020 



#13 
#1D 

INVKEERR-1 , X 
SCREENLOC, Y 



$010 

IOBEEP 

$020 



LOAD X-REGISTER WITH $13 
LOAD Y-REGISTER WITH $1D 

LOAD ACCUMULATOR WITH INVALID KERNEL ERROR 

MESSAGE BYTE 

WRITE IT TO THE SCREEN 

DECREMENT Y-REGISTER 

DECREMENT X-REGISTER 

BRANCH IF MORE CHARACTERS TO WRITE ON SCREEN 
BEEP SPEEKER 
HANG FOREVER ! ! 



This section writes the disk error message to the screen. 



WRDISKERR 



$010 



$020 



LDX 
LDY 
LDA 
STA 
DEY 
DEX 
BNE 
LDA 
JMP 



#0A 
#18 

DISKERR-1, X 
SCREENLOC, Y 



$010 

IOBEEP 

$020 



LOAD X-REGISTER WITH $0A 
LOAD Y-REGISTER WITH $18 

LOAD ACCUMULATOR WITH DISK ERROR MESSAGE BYTE 
WRITE IT TO THE SCREEN 
DECREMENT Y-REGISTER 
DECREMENT X-REGISTER 

BRANCH IF MORE CHARACTERS TO WRITE ON SCREEN 
BEEP SPEEKER 
HANG FOREVER ! ! 



STORAGE FOR THE ERROR MESSAGE AND FILE VERIFICATION ROUTINES 



FLNMELEN 
2E 4B 45 52 FLNME 

20 4B 52 4E FLVERIFY 



45 20 27 53 

4B 45 52 4E 

20 4E 4F 54 

55 4E 44 

41 4C 49 44 

52 4E 45 4C 
4C 45 

4B 20 45 52 



NTFNDERR 



.BYTE 
.ASCII 



.ASCII 
.ASCII 



0A 

"SOS. KERNEL' 



"SOS KRNL" 

"FILE 'SOS. KERNEL' NOT FOUND" 



INVKEERR .ASCII "INVALID KERNEL FILE" 
DISKERR .ASCII "DISK ERROR" 
.END 



SYMBOL TABLE DUMP 



AB - Absolute 
RF - Ref 
PB - Public 

BOOTS TRA PR 



LB - Label 

DF - Def 

PV - Private 



UD - Undefined 
PR - Proc 
CS - Consts 



MC 
FC 



Macro 
Func 



I BREG 



AB FFEF | DISKERR LB A1D3 | ENTRY 



LB A000 | EREG 



AB FFDF | 
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HD: Apple ///:SOS Floppy Bootstrap Loader Page 5 ^ 








FILECNT 


AB 00E5 | 


FIRSTPAG AB 2000 | FLNME 


LB A193 I 


r ljl.XnCj.Li.EjlN J-iD t\±?£. | C ijV£jr\lf I LiJtJ AIDU | 








FLVRFY 


LB A0E2 | 


FLVRFYLP LB A0E4 | IBBUFP 


AB 0085 | 


IBBUFPTM AB 00E3 | IBCMD AB 0087 | 








IBDRVN 


AB 0082 | 


IBSECT AB 0084 | IBTRK 


AR 0JCJfi ~K I 

jtuj x/xJOO | 


TnYRTTO j\r oicoioi l t piyht \o an anaa i 

X J_il\ 1 t\D %J\-AOiO | J. UAoLlx/; A rS YjYjYjVj \ 








INDXBLKC 


AB 00E7 | 


INVKEERR LB A1C0 | IOBEEP 


AB C040 | 


JUMPSOSK LB A10B | KBDSTROB AB C010 | 








LOADADR 


AB 1E00 | 


MAINBUFF AB A200 | NMIVECTO 


AB FFCA | 


NTFNDERR LB A1A5 | OFFSET AB 1E08 | 








RD1SOSKE 


LB A0D1 | 


RDSOSDIR LB A02E | RDSOSKEL 


LB A0F6 | 


RDSOSKER LB A0F2 | READBLK LB All D | 








READIDXB 


LB A0BE | 


READSOSD LB A024 | REGRWTS 


AB F000 | 


RET INT AB 0040 | SCREENLO AB 0628 | 








SECTABL 


AB F4A0 | 


SOSJMPAD AB 00E8 | SRCHLP 


LB A06C | 


SRCHSOSK LB A047 | WRDISKER LB A17E | 








WRINKERE 


LB A16A | 


WRNTFNDE LB A156 | 










Assembly 


complete : 


363 lines 












Errors flagged 


on this Assembly 












6502 OPCODE STATIC 


FREQUENCIES 












ADC 


: 4 | 


* * * * 












AND 


: 3 | 


* * * 












BCC 


: 2 | 


** 












BCS 


: 3 | 


** * 












BEQ 


: 6 | 


****** 












BIT 


: 1 m 


* 












BNE 


: 15 | 


*************** 












CLC 


: 2 | 


* * 












CLD 


: 1 m 


* 












CMP 


i 4 | 


** * * 












CPX 


: 2 | 


* * 












DEC 


: 3 | 


* * * 












DEX 


5 I 


***** 












DEY 


5 I 


***** 












INC 


6 1 


****** 












I NY 


2 1 


* * 












JMP 


7 1 


******* 












JSR 


6 1 


****** 












LDA 


37 M 


************************************* 










LDX 


12 | 


************ 












LDY 


14 | 


************** 












LSR 


3 I 


* * * 












ORA 


1 m 














PHP 


1 m 


* 












PLP 


1 m 


* 












ROR 


3 I 


* * * 












RTS 


1 m 


* 












SBC 


2 I 


* * 












SEC 


1 m 


* 












SEI 


1 m 


* 












STA 


23 | 


*********************** 












STX 


2 1 


* * 












STY 


6 1 


****** 












TAX 


3 I 


* * * 












TAY 


1 m 


* 












TXA . 


1 m 


* 












TXS : 


3 I 


* * * 












Minimum frequency = 1 












Maximum frequency = 37 












Average frequency = 5 












Unused opcodes: 














ASL 


BMI BPL 


BRK BVC BVS CLI CLV CPY 


EOR I NX 


NOP PHA PLA ROL RTI 








SED 


TSX TYA 














Program opcode 


usage: 66 % 












(1.00) That's all, 


Folks . . . 












< 
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* Apple /// Computer Information 

APPLE /// SOS BOOTSTRAP LOADER 
HEXADECIMAL DUMP 

Source 

DISKLdofile as found with Chris Smolinski's Macintosh SARA emulator application 

Printed by David T. Craig • December 1997 

This hex dump, which was produced by the Apple Macintosh MPW DumpFile tool, lists the 
Apple /// SOS Bootstrap Loader. This 512 byte loader exists at block of SOS disks and is 
loaded by the Apple /// ROM into memory addresses $A000-$A1FF. This code's purpose is 
to begin the loading of SOS from the floppy disk into the ///'s memory. 

0: 4C 6E AO 53 4F 53 20 42 4F 4F 54 20 20 31 2E 31 LntSOS . BOOT . . 1 . 1 

10: 20 OA 53 4F 53 2E 4B 45 52 4E 45 4C 20 20 20 20 ..SOS. KERNEL 

20: 20 53 4F 53 20 4B 52 4E 4C 49 2F 4F 20 45 52 52 . SOS . KRNLI/O . ERR 
30: 4F 52 08 00 46 49 4C 45 20 27 53 4F 53 2E 4B 45 OR. . FILE . 1 SOS .KE 
40: 52 4E 45 4C 27 20 4E 4F 54 20 46 4F 55 4E 44 25 RNEL 1 . NOT . FOUND% 
50: 00 49 4E 56 41 4C 49 44 20 4B 45 52 4E 45 4C 20 . INVALID. KERNEL . 

60: 46 49 4C 45 3A 00 00 0C 00 IE 0E IE 04 A4 78 D8 FILE: §xy 

70: A9 77 8D DF FF A2 FB 9A 2C 10 CO A9 40 8D CA FF ©wgfTC°6, . <;©@g v 
80: A9 07 8D EF FF A2 00 CE EF FF 8E 00 20 AD 00 20 ©. gQ^C .CE6"e . . 
90: DO F5 A9 01 85 E0 A9 00 85 El A9 00 85 85 A9 A2 -1©.6*©.6-©.66©C 
AO: 85 86 20 BE Al E6 E0 A9 00 85 E6 E6 86 E6 86 E6 OU . ae°E t© . OEEUEUE 
B0: E6 20 BE Al AO 02 Bl 85 85 E0 C8 Bl 85 85 El DO E . ae° t . ±66 1 »±66 • - 
CO: EA A5 E0 DO E6 AD 6C AO 85 E2 AD 6D AO 85 E3 18 !• t-E*l t6 ,*mt6„ . 
DO: A5 E3 69 02 85 E5 38 A5 E2 ED 23 A4 85 E4 A5 E5 • „i . OA8 • , I#§6&>*A 
E0: E9 00 85 E5 AO 00 Bl E2 29 OF CD 11 AO DO 21 A8 E . OAf . + , ) . O . t - ! ® 
F0: Bl E2 D9 11 AO DO 19 88 DO F6 AO 00 Bl E2 29 F0 ±, Y . t- . a-~ t . + , ) # 

100: 53 4F 53 20 4B 52 4E 4C 62 00 01 00 0E 2E 44 31 SOS . KRNLb Dl 

110: 2F 53 4F 53 2E 49 4E 54 45 52 50 AA A5 AO F9 AO /SOS . INTERP™» t w t 
120: AO A5 AO AO A5 AO AO C5 AO AO 98 AO F0 Al AO CC t • t t • t t«t t6t*°tA 
130: AO AO C5 AO AO AO AO AO EE AO AO C4 OE 2E 44 31 t t«t t t t tOt \f . . Dl 
140: 2F 53 4F 53 2E 44 52 49 56 45 52 FF 9A AO FF 9A /SOS . DRIVER v ot 
150: AO AO AO AO DO AO AO CI AO AO 8A AO AO F9 AO CI t t t t-t t i t tat t " t i 
160: E9 AO 9E Al AO F5 AO AO A5 AO AO 88 00 00 88 OC Etu°Ut t • t ta. . a. 
170: A9 00 AA 9D 00 1A 9D 00 16 9D 00 IB 9D 00 18 9D ©.™u . . u . . u . . u . . u 
180: 00 14 9D 00 01 CA DO EB A9 30 8D DF FF A2 FB 9A ..u.. -l©0gfTC°6 
190: A9 1A 8D DO FF 20 D4 IF AD DF FF 29 10 09 28 8D ©.g- v . x .*fT) . . (g 
1A0: DF FF A2 FF 9A A9 1A 8D DO FF AD 01 19 8D EF FF fT C v 6©. g- v * . . g6" 
1B0: 6C 02 00 AA AD EF FF 48 8E EF FF A5 27 05 26 FO 1 . .^S'HeS" • ' . 
ICO: 33 A5 26 DO 02 C6 27 C6 26 18 A5 23 65 27 85 23 3 A' A&. »#e '6# 
1D0: A5 25 65 27 85 25 E6 27 A4 26 FO 07 Bl 22 91 24 *%e ' 6%E ' §&# .+"e$ 
1E0: 88 DO F9 Bl 22 91 24 88 C6 23 C6 25 C6 27 DO EC a-~±"e$aA#A%A ' -I 
1F0: E6 23 E6 25 68 8D EF FF 60 18 A5 24 65 10 85 10 E#E%hg6 v x . • $e . 6 . 

### 
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